home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / makeqlb.zip / MAKEQLB.DOC < prev    next >
Text File  |  1990-06-05  |  5KB  |  86 lines

  1.                            MAKEQLB.EXE
  2.                              
  3.          Utility program contained in QuickPak Professional
  4.                                by
  5.                       Crescent Software Inc.
  6.                          32 Seventy Acres
  7.                       West Redding. CT 06896
  8.                          (203) 438-5300
  9.                            
  10.  
  11. MakeQLB will examine a program and all of its dependent modules, and create a
  12. new Quick Library containing only those routines that are necessary.  This is
  13. important when the programs you develop are very large, because it eliminates
  14. the wasted memory taken by routines that are not used.  MakeQLB also allows
  15. you to easily combine routines from multiple library files, without having to
  16. extract each individual object module.
  17.  
  18. MakeQLB knows which routines are to be included by examining your main
  19. program for CALL statements.  It also searches for DECLARE statements when
  20. the CALL key word is not used, or when there are functions.  MakeQLB searches
  21. Include files to any level and the .MAK file if one is present, to account
  22. for all of the modules in a complete program.
  23.  
  24. MakeQLB will automatically report any subprograms or functions that have been
  25. declared but are not being used.  Of course, those routines will not be added
  26. to the resultant Quick Library.  It will also report any subprograms and
  27. functions that are present but never called.  As an option, you may specify a
  28. file that contains a list of all the routines that are to be included in the
  29. library, rather than having MakeQLB examine your source files.  Further, the
  30. program will create a list file suitable for later use, so it does not have
  31. to examine the entire program again.
  32.  
  33. MakeQLB uses an interface similar to the LINK and LIB programs, and you may
  34. either enter the parameters on a single line, or wait for MakeQLB to prompt
  35. you for them.  The command line syntax is as follows:
  36.  
  37.     MAKEQLB mainprog|routines.lst [objname], qlbname, listfile, _
  38.             lib1 [lib2], bqlbname
  39.  
  40. Mainprog is the main BASIC program to examine, with a .BAS extension assumed.
  41. If a file name with a .LST extension is given, MakeQLB will instead use the
  42. procedure names contained in that file when creating the Quick Library.
  43.  
  44. Objname is an optional parameter which can be used to specify one or more
  45. additional object files that are not in any of the listed libraries.
  46.  
  47. Qlbname is the name of the resultant Quick Library.  If the name is omitted,
  48. a library will be created with same name as the main program, but with a .QLB
  49. extension.  However, you must add a delimiting comma if the qlbname parameter
  50. is not used.
  51.  
  52. The list file that is created contains a list of all the routines names that
  53. are being added to the Quick Library.  This file defaults to a .LST extension,
  54. and is in the correct format that MakeQLB requires to create a library from a
  55. list of procedure names.  This way, if you need to add a routine or two to
  56. the Quick Library later on, you can simply edit the list file.  Creating a
  57. Quick Library from a list file is of course much faster than examining an
  58. entire BASIC program.  If the listfile parameter is omitted, the same name as
  59. the main program will be used, but with a .LST extension.  To tell MakeQLB
  60. not to create a list file, use the reserved DOS name NUL for that parameter.
  61.  
  62. The lib1 and lib2 parameters are library files (.LIB extension) that contain
  63. the procedures being added to the Quick Library.  One or more library names
  64. may be specified, with a blank space used to delimit each name.  If no
  65. library name is given, the name PRO.LIB is assumed.
  66.  
  67. The last parameter tells MakeQLB which "bqlb" support library is to be 
  68. specified when linking.  The default name is BQLB45.LIB, which is the library
  69. that comes with QuickBASIC version 4.5.  If you are using MakeQLB with BASIC
  70. 7.0 PDS you should specify QBXQLB instead.
  71.  
  72. MakeQLB works by creating an object file that contains the list of procedure
  73. names.  By establishing these procedures as External, they will be included
  74. in the Quick Library automatically when MakeQLB invokes LINK.  The dirty work
  75. of extracting each routine from the various .LIB files is thus handled
  76. entirely by LINK.
  77.  
  78. Crescent Software publishes many useful products for BASIC programmers.  We
  79. offer general purpose tools, as well as programs for graphics, screen design,
  80. database management, scientific applications, and more.  All products include
  81. complete source code, and royalties are never required.  Please call or write
  82. for information on our entire line.
  83.  
  84. We at Crescent Software have provided this program as a service to the BASIC
  85. programming community, and hope that you find it useful.
  86.